home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / smtping.z / smtping
Encoding:
Text File  |  1998-10-30  |  8.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. SSSSMMMMTTTTPPPPIIIINNNNGGGG((((1111MMMM))))                                                        SSSSMMMMTTTTPPPPIIIINNNNGGGG((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      smtping - send FDDI SMT Echo Request frames to FDDI stations
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ssssmmmmttttppppiiiinnnngggg [----ddddffffnnnnqqqqvvvv] [----cccc _c_o_u_n_t] [----ssss _s_i_z_e] [----llll _p_r_e_l_o_a_d]
  13.           [----iiii _i_n_t_e_r_v_a_l] [----IIII _i_n_t_e_r_f_a_c_e] [----pppp _p_a_t_t_e_r_n] _h_o_s_t
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _s_m_t_p_i_n_g is a tool for FDDI ring testing, measurement and management.  It
  17.      sends the FDDI Station Management (SMT) Echo request frames to elicit an
  18.      Echo response frame from other FDDI stations or concentrators. Echo
  19.      request frames (``pings'') have a MAC header, a SMT header, a transaction
  20.      ID and an INFO field.  The INFO field has an 8-byte timestamp, and then
  21.      an arbitrary number of ``pad'' bytes used to fill out the packet.  The
  22.      _s_m_t_p_i_n_g tests for SMT connectivity; the related utility, _p_i_n_g(1M), tests
  23.      for the higher-level IP/ICMP connectivity.
  24.  
  25.      The _h_o_s_t can be a MAC address of a host or the symbolic name of its MAC
  26.      address which can be found in /_e_t_c/_e_t_h_e_r_s or the NIS _e_t_h_e_r_s._b_y_n_a_m_e map.
  27.      The options are:
  28.  
  29.      ----cccc _c_o_u_n_t
  30.           Stop after sending (and receiving) _c_o_u_n_t Echo frames.
  31.  
  32.      ----dddd   Set the SO_DEBUG option on the socket being used.
  33.  
  34.      ----ffff   Flood ping.  Outputs frames as fast as they come back or one hundred
  35.           times per second, whichever is more.  For every Echo request frame
  36.           sent, a period '.'  is printed, while for every Echo response
  37.           received a backspace is printed.  This provides a rapid display of
  38.           how many packets are being dropped.  _F_l_o_o_d_i_n_g _c_a_n _b_e _e_x_t_r_e_m_e_l_y
  39.           _s_t_r_e_s_s_f_u_l _o_n _a _n_e_t_w_o_r_k _a_n_d _s_h_o_u_l_d _b_e _u_s_e_d _w_i_t_h _c_a_u_t_i_o_n.
  40.  
  41.      ----iiii _i_n_t_e_r_v_a_l
  42.           Wait _i_n_t_e_r_v_a_l seconds between sending each frame. The default is to
  43.           wait for one second between each packet.  This option is
  44.           incompatible with the ----ffff option.
  45.  
  46.      ----llll _p_r_e_l_o_a_d
  47.           Send _p_r_e_l_o_a_d frames as fast as possible before falling into the
  48.           normal mode of behavior.
  49.  
  50.      ----nnnn   Numeric output only.  Does not try to translate the MAC address into
  51.           its symbolic name in the _e_t_h_e_r_s database.
  52.  
  53.      ----pppp _p_a_t_t_e_r_n
  54.           Specify up to 16 ``pad'' bytes to fill out the frames sent.  This
  55.           option is useful for diagnosing data-dependent problems in a
  56.           network.  For example, ``-p ff'' will cause the sent frames to be
  57.           filled with all 1s.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSMMMMTTTTPPPPIIIINNNNGGGG((((1111MMMM))))                                                        SSSSMMMMTTTTPPPPIIIINNNNGGGG((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----IIII _i_n_t_e_r_f_a_c_e
  75.           Use _i_n_t_e_r_f_a_c_e to send each ECHO frame and receive responses. The
  76.           _i_n_t_e_r_f_a_c_e is a string of the form ``name unit'', for example,
  77.           ``ipg0''.  The default is set to the station's primary interface.
  78.  
  79.      ----qqqq   Quiet output.  Nothing is displayed except the summary line on
  80.           termination.
  81.  
  82.      ----ssss _s_i_z_e
  83.           Send frames containing _s_i_z_e bytes of data.  The default is 12, which
  84.           translates into 64-byte SMT frame.  The maximum allowed value is
  85.           65468 bytes(even though _s_m_t_p_i_n_g accepts up to 65468 bytes of packet
  86.           size, any _s_i_z_e larger than 4500 will result in failure because the
  87.           maximum FDDI packet size is 4500).
  88.  
  89.      ----vvvv   Verbose output.  SMT frames other than Echo responses that are
  90.           received are listed.
  91.  
  92.      _s_m_t_p_i_n_g should be used primarily for manual fault isolation.  Because of
  93.      the load it can impose on the network, it is unwise to use _s_m_t_p_i_n_g during
  94.      normal operations or from automated scripts.
  95.  
  96.      _s_m_t_p_i_n_g continually sends one frame per second and prints one line of
  97.      output for every Echo response returned.  If the ----cccc _c_o_u_n_t option is
  98.      given, only that number of requests is sent.  No output is produced if
  99.      the station does not respond.  Roundtrip times and frame loss statistics
  100.      are computed.  If duplicate frames are received, they are not included in
  101.      the frame loss calculation, although the round trip time of these frames
  102.      is used in calculating the minimum/average/maximum round-trip time
  103.      numbers.  When the specified number of frames have been sent (and
  104.      received) or if the program is terminated with an interrupt (SIGINT), a
  105.      brief summary is displayed.  When not using the ----ffff (flood) option, the
  106.      first interrupt, usually generated by control-C or DEL, causes _s_m_t_p_i_n_g to
  107.      wait for its outstanding requests to return.  It will wait no longer than
  108.      the longest round trip time encountered by previous, successful pings.
  109.      The second interrupt stops _s_m_t_p_i_n_g immediately.
  110.  
  111. DDDDUUUUPPPPLLLLIIIICCCCAAAATTTTEEEE AAAANNNNDDDD DDDDAAAAMMMMAAAAGGGGEEEEDDDD PPPPAAAACCCCKKKKEEEETTTTSSSS
  112.      _s_m_t_p_i_n_g will report duplicate and damaged packets.  Duplicate packets are
  113.      expected if the target address is a multicast or broadcast address;
  114.      otherwise duplicates are not expected.
  115.  
  116.      Damaged packets are obviously serious cause for alarm and often indicate
  117.      broken hardware somewhere in the _s_m_t_p_i_n_g packet's path (in the network or
  118.      in the hosts).
  119.  
  120. TTTTRRRRYYYYIIIINNNNGGGG DDDDIIIIFFFFFFFFEEEERRRREEEENNNNTTTT DDDDAAAATTTTAAAA PPPPAAAATTTTTTTTEEEERRRRNNNNSSSS
  121.      The link-level layer should never treat packets differently depending on
  122.      the data contained in the data portion.  Unfortunately, data-dependent
  123.      problems have been known to sneak into networks and remain undetected for
  124.      long periods of time.  In many cases the particular pattern that will
  125.      have problems is something that doesn't have sufficient ``transitions'',
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSMMMMTTTTPPPPIIIINNNNGGGG((((1111MMMM))))                                                        SSSSMMMMTTTTPPPPIIIINNNNGGGG((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      such as all 1s or all 0s, or a pattern right at the edge, such as almost
  141.      all 0s.  It isn't necessarily enough to specify a data pattern of all 0s
  142.      (for example) on the command line because the pattern that is of interest
  143.      is at the data link level, and the relationship between what you type and
  144.      what the controllers transmit can be complicated.
  145.  
  146.      If you have a data-dependent problem you will probably have to do a lot
  147.      of testing to find it.  If you are lucky, you may manage to find a file
  148.      that either can't be sent across your network or takes much longer to
  149.      transfer than other similar length files.  You can then examine this file
  150.      for repeated patterns that you can test using the ----pppp option of _s_m_t_p_i_n_g.
  151.  
  152. FFFFIIIILLLLEEEESSSS
  153.      /etc/ethers    MAC address database
  154.  
  155. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  156.      smtstat(1), smtconfig(1M), ethers(4)
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.